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Chapter ] - [Introduction 


This manual describes the installation and use of Version 5.00 
of the Serial Communication Controller option for the Compucorp 
610 and 625 Mark II Desk Top Computers. 


The Serial Communication Controller consists of One Circuit 
board, with 2 channels, 2 I/O connectors with their associated 
Wiring to the circuit board, and machine language Serial Comm 
unications Port Driver and Initializer programs. The port driver 
Operates with the 625 and 610 Series. Operating System Version 
9-00 or higher. It does not operate with eariiler versions. A 
working knowledge of BASIC programming and ZEBRA Monitor is 
hecessary to make proper use of this manual. 


THE PORT DRIVER PROGRAM REQUIRES INSTALLATION OF THE RECEIVE 
LINE SIGNAL DETECT OPTION ON THE CIRCUIT BOARD, IN ORDER TO 
FUNCTION CORRECTLY (See Chapter 2). 


VERSION 5.00 SUPPORTS ONLY THE ASYNCHRONOUS MODE OF OPERATION. 


Compucorp assumes no liability concerning the accuracy of 


information contained in this manual, 


& 
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tek Conti ion 
The Serial Communications Port Driver, Initializer, and manual 


are furnished on a nonsystem disk, Compucorp p/n 9412586. The 
following files are included: 7 


File name ~ Description 

SCCDRIVER Port driver program. 

SCCINIT Initializer program. 
SCCMANUAL Programmer's manual. | 
SCCPRINT Program to print the manual. 
SCPRES & SCPDEFS Port driver source, 

SCPINIT | Initializer source. 

ASM1 JCL file to assemble driver. 
~ASM2  JCL file to assemble init. 
EX1 BASIC example l. 

EX2 BASIC example 2. 

EX3 | BASIC example 3. 

EX4 . BASIC example 4. 


The driver and initializer programs may be transferred to app- 
lications diskettes as required. The programmer's manual may be 
Printed by loading SCCPRINT in BASIC, and then issuing RUN. A 
copy will be printed on the SIO device. 


If there should be any need to re-assemble the SCC programs, the 
procedure (in ZEBRA, after SIO has’ been initialized) is as 
follows: : . 


A3 = SIO 

OPEN ASM1 (or ASM2, for the initializer) 

USED LUN xx | 3 
A4 = xx . 


OPEN SCCDRIVER (or SCCINIT, for the initializer) 
USED LUN yy 


A5 = yy 
G ASSEMBLER 
PASS = 1 
ENTER VERSION NUMBER (2 DIGITS) 
:nn | (decimal part of Version number; e.g. 5.nn) 
PASS = p (p=4 for object program and listing). 
PASS = 0 


The Version 5.00 SCC driver represents a major revision of Ver- 
sion 1.00. Applications programs written using Version 1.00 may 
not be compatible with Version 5.00. 
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Chapter 2 - Configuration 


Before the Serial Communications Controller board is installed 
in the computer, the controller addresses must be set using the 
Slide switches on the circuit board, and board jumpers must be 
configured correctly. Current Mode operation, Receive Line 
Signal. Detect, and the Clock Source, are options selectable by 
modifying jumpers on the circuit board. Refer to the Compucorp 
Application Note - Input/Output Port Assignment (p/n 0030437) 
which describes both the board locations within the computer, 
and the standard I/O address allocations. , 


LO r Addres 


The controller address is selected by setting 5 slide switches, 
located on the circuit board. The switch signal names are print- 
ed on the board. BE SURE TO USE THESE NAMES AND NOT THE SWITCH 
NUMBERS FOUND ON THE SLIDE SWITCH HOLDER. The controller address 
and one more bit of the address are combined to form the _ spec- 
ific channel address. The controller address structure is: 


AT AG A5 AA A3 A2 Al a 
{-------Switch Selectable-~-------- } {control} {channel {control} 
selection} 


The slide switches when off = 1, when on = 0. The on position is 
marked on the slide switch holder. The controller address range 
is 00000XXX to 11111XXX, with some limitations (see the App- 
lication Note referred to above). The SCC board is normally 
Shipped with the address set to 60 hex. This address is recom 
mended for normal use when only 1 board is installed. Second and 
subsequent boards will require different addresses. 


The channel selection bit is used by the driver program to add- 
ress the upper and lower channels on the circuit board. The 
upper channel is Al=l and the lower channel is Al=0. For 
example, if 60 is selected for the controller address, then 60 
is the lower channel address and 62 is the upper channel address 


| When the address switches on the controller board are set to 60, 
then I/O addresses 60, 61, 64, and 65 are used for channel 0, 
and I/O addresses 62, 63, 66, and 67 are used for channel l. 
Other hardware devices must not use these I/O addresses. 

The switch settings for the recommended address (60) are: 


Switch Setting 


AS of £(1) These are listed 
A4 | on (0) here in the or- 
A6- off(1) der they appear 3 
A7 on (0) on the Serial Int- 
A3 on (0) erface Board. 
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The Serial Communications circuit board must be installed to the 
pec. OF Ehe CP) circuit board. If the SCC board is not installed 
correctly, there is a chance of losing an interrupt, or comp- 
letely deadlocking the operating system. The components’ face 
left, as with all other boards in the system. Please refer to 


the Application Note (p/n 0030437) mentioned above, for further 
information, | | 


Installation 
ies wet the Controller Address : 
a Install current loop option if required. 
b. Modify Receive Line Signal Detect jumpers as required 
| by the SCC driver. 
2. Remove the power plug from the computer. — 
- Remove the cover from the computer. 


a. remove 1 screw from beneath each of the front corners, 
b. remove 4 screws holding cover to rear metal panel. 


4. Install the circuit board, without the cables to the I/O 


connectors, | | 

5. Remove protective cover from 2 I/O connector holes in back 
panel. | 

6. Loosen screws on rear panel to ease installation of I/O 
connectors, 7 | 


7. Install I/O connectors on rear panel, and plug cables into 
board. : 


8. Stick the supplied labels on the back panel below the 


connectors, The lower channel connector is OPT 15 SCC Ch 0, 
and the upper channel connector OPT 15 SCC Chl. 

9. Re-tighten rear panel. ee 

10. Seal any unused I/O connector holes that are exposed. 

ll. Install cover, | 

12. Restore power. 


Current Mode Option 


Current mode operation is available as an option kit with isol- 
ation provided by optical couplers. To order the option from 
Compucorp, Order Option 625-017. The option contains parts suff- 
icient to convert one or both channels. 


Receive Line Signal Detect Option 


Receive Line Signal Detect interrupt is available as a jumper 
Strap option on the circuit board. When selected, this option 
takes the place of the Transmitter Empty (TxE) interrupt signal. 
It does not however replace the TxE STATUS signal generated by 
the. SCC. The Transmitter Empty signal is used in half-duplex 
mode to signal that an output operation is complete, and that 
line turnaround may be effected to allow input. Option jumper 
locations can be found on the Component Placement Drawing for 
0167874, the Serial Interface Board (see Appendix III).They are 


wll 
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Selected as follows: 


Port Selection Transmitter Receive Line 
Bit Empty Signal Detect 
0 J8 J7 
iE J6 J5 


THIS OPTION IS REQUIRED BY THE SCC DRIVER VERSION 5.00 AND 
HIGHER, THAT IS, JUMPERS J6 AND J8 MUST BE REMOVED, AND JUMPERS 
J5 AND J7 MUST BE INSTALLED. See Chapter 3 for a description of 
the Receive Line Signal Detect function. 


tion 


The SCC board is supplied with the internal baud rate generator 
as the clock source. Jumper straps on the circuit board can 
Select external clock sources for timing the transmit data 
and/or receive data lines. For asynchronous operation, internal 
clocking is required, and these jumpers should not be altered. 
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Chapter 3 - Interface 


The Serial Communications Controller I/O connectors are Cannon 
DB25S or equivalent. The mating male connector to be used to 
cable to the I/O device is Cannon DB25P or equivalent, 


Pin Assignments 

Pin Signal Description Abbreviation Direction 
SecuGlTT <RS232 | Computer-Modem 
1 101 AA Protective Ground 

2 101 BA Transmitted Data TxD -> 
a £04 BB Received Data RxD | <- 
4 ae 6 CA Request to Send RTS cad 
5 106 CB Clear to Send CTS es, 
6 107 ae Data Set Ready DSR <= 
“f 102 AB Signal Ground 

8 109 CF Receive Line Signal Detect RLSD <- 
9 No Connection 3 

10 No Connection 

ll Receive plus current source 

Le | Receive plus current data 

13 No Connection 

14 Receive minus current source 

Ls; 114 DB Transmit Clock (DCE) TxC <- 
16 Transmit plus current source | 

ge 115 DD Receive Clock (DCE) 7 RxC {+ 
18 Transmit plus current data 

19 Transmit minus current data 

o- 6=106.2.-CD Data Terminal Ready DTR => 
21 Transmit minus current source 

oe 6125 CE Ring Indicator RI <= 
23 ; Tie to pin 3 if current mode 3 

ze LL3 DA Transmit Clock (DTE) dp -> 
25 Receive minus current data 

Signal Functions 


In general, a terminal may be connected to an SCC port either 
directly or via modems (or modem equivalents). For any one type 
of terminal or modem, a specific subset of the above Signals 
will be utilised; thus the cabling requirements will be specific 
to the particular type of modem or terminal equipment supported. 
A range of cabling requirements is shown in the examples in 
Chapter 5. | 


The intent.of the standard RS232 signals, and the way in which 
each 1s actually used by the SCC driver is as follows: 


Protective Ground (Pin 1) 


Grounded to the frame of the computer. 


& 


-8- 


LIS ert reese ESSEC SSCSSESESESSESEESCSSSSESESECESSSESSGISGIGSSGSSESSESCSESCELE 


FERRER ERE EERE ERE RE RE RE RES ERE REE EEEESEES ELVES E EER EE 


Transmitted Data (Pin 2) 


Carries data sent from the computer to the external device, 
Peaquited by the driver for all protocols except simplex 


input (see Chapter 4 - the SET command). 


Received Data (Pin 3) 


Carries data sent from the external device to the computer. 
Required by the driver for all protocols except simplex 


output, 


Request To Send (Pin 4) 


status signal controlled by the driver indicating that the 
computer is ready to send data. Usually required only for 


half-duplex communications via modems, in which case 
can only be transmitted in one direction at a time. 
modem responds to this request for line turnaround by 
ing its Clear To Send signal. 


Clear To Send (Pin 5) 


data 


The | 


rais- 


Status line controlled by the external device indicating 


that it is ready to accept data from the computer. 


The 


driver will only transmit data while this Signal iS present. 
If no external connection is made to pin 5, the line floats 
high (as if a signal were present). Its use is as indicated 


above (Request To Send), for half-duplex communications 


via 
modems, For direct connection to an asynchronous terminal, 
the terminal may need to control the transmission rate of 


the computer, For example, the TI-810 printer can provide a 
Signal (pin 11 on its connector) which is high whenever it 


Can accept data from the line, but which goes low. when 


the 


print buffer is full; thus by connecting its pin 11 to pin 5 


on..the SCC port, the printer can automatically prevent 


any 


data loss due to. overrun, (see also SPECIAL USE of Data 


Terminal Ready, below). 


Data Set Ready (Pin 6) 


Status line controlled by the external device indicating 
that it is online. The SCC driver ignores this signal; how- 
ever, i1f no external connection is made to pin 6, the line 


floats high (as if a signal were present). 


Signal Ground (Pin 7) 


Common ground reference potential for all other Signals 


except Protective Ground. 


Receive Line Signal Detect (Pin 8) 


Status line controlled by the external device indicating 
that a communication path has been established. The driver 
will only transmit data while this Signal is present, and 
will signal an error condition (Carrier Lost - see Chapter 
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4) if it goes low once communication has commenced. A con- 
nection must be made to pin 8, since the line floats low in 
the absence of one (as if no signal were present). When 
communication is via modems, the local modem supplies this 
Signal to the SCC port upon receipt of a carrier signal from 
the remote modem. By requiring the presence of this signal, 
the driver can support either a dedicated link (a fixed line 
between the modems), or a dial-up link (e.g. via the switch- 
ed telephone network). For direct connection to a terminal, 
either the terminal can supply this signal (e.g. its DTR 
Signal), or pin 16 can be tied to pin 8 (since pin 16 of the 
SCC connector is always high). 3 


Transmit Clock (DCE) (Pin 15) 


Timing signal supplied by an external clock source that may 
be used to control the rate of data transmission from the 
computer, when operating in synchronous mode. No connection 
is required to this pin for operation in asynchronous’ mode, 
Since the SCC supplies an internal clock source. 


Receive Clock (DCE) (Pin 17) 


Timing signal supplied by an external clock source that is 
used for synchronous data reception. No connection is req- 
uired to this pin for operation in asynchronous mode. 


Data Terminal Ready (Pin 20) 


status signal controlled by the computer indicating that it 
is online, and that a communication path may be established 
to the remote terminal. Usually required only for commun- 
ication via modems. For a dial-up link via modems, if the 
DTR Signal goes low after communication has been initiated 
(e.g. if the user program issues a SET statement - see Chap- 
ter 4), the local modem may disconnect the line; this will 
depend on the type of modem used. The SCC -driver makes 
SPECIAL USE of the DTR signal to provide an indication of 
its receive status; if its input buffer (receiving data from 
the line) is almost full, the driver will set DTR low until 
it has had a chance to process some of the buffer data. For 
direct connection to a terminal, the DTR signal from the SCC 
may thus be used to control the Clear To Send line at the 
cerninal (pin 5), This special use conflicts, of course, 
with communication via modems, since a buffer full condition 
at the computer could result in disconnection of the link; 
to avgid this, ensure that the input -buftfer size is 
Sufficiently large that it will not normally be filled. 


Ring Indicator (Pin 22) 


Status line used only for control by an auto-answer modem to 
indicate that a remote station has dialed-up and wishes to 
establish a communication path to the computer. The driver 
responds by raising DTR, and the modem will then raise RLSD 
to pin 8 of the SCC port. 
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Transmit Clock (DTE) (Pin 24) 


Timing signal supplied by the internal clock source of the 
SCC, that may be used to control the rate of data trans- 
mission from the computer, when Operating in synchronous 
mode. No connection is required to this pin for operation in 


asynchronous’) mode, 
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apter 4 -— Programmin 


The SCC driver program provides a number of primary functions — 
that may be invoked from an Assembler language program via LION 
calls, or from a BASIC language program via standard BASIC 
Statements, In this section, we will only discuss the latter. 


The driver software must be used with Operating System Version 


9.00 or higher. As with all other optional physical drivers, it 
consists of two components - the serial driver, and an initiali- 
zer which defines the ports that will be used and sets default 
parameter values. These default values may be subsequently 
overridden using the SET statement described later in this 
Chapter. | 


ments 


The driver program, SCCDRIVER, uses slightly more than 2000 


bytes. It must be in memory whenever serial channels are being 
used, It cannot be released after at least one SCC port has been 
initialized with SCCINIT. 


Tne initializer program, SCCINIT, uses slightly less. than 1300 
bytes, After initialization, the program is automatically re- 
leased, and the memory used is returned to the system buffer. 


Fach initialized full-duplex port requires 62 bytes, plus’ the 
input and output queue sizes specified in the SET statement. 
Other ports (half-duplex or Simplex) require 54 bytes each, plus 
the input or output queue Size specified. A_ serial channel 
cannot be released after it is initialized. | — 


Ltializi the Seria iver 


The driver may be loaded from ZEBRA, interactively or in a SYS- 
TEMSTART file; or it may be loaded with BASIC commands, either 
interactively, from a program, or from SYSTEMSTART. During the 
initialization, the I/O Address, as set on the interface board 
Switches, is input, the name of the serial channel (the name 
will be used in BASIC statements) is input, and messages. des- 
Cribing the success or failure of the initialization are re- 
turned, Initializing involves: 


* Loading the serial driver program. 

* Loading and executing the initializer program. The 
initializer must be executed once for’ each serial 
channel to be used. 7 


Instructions to load the driver should only be issued once. If 
another instruction to load the driver is issued after the ini- 
tializer is executed, another copy of the driver will be loaded 
into memory. Multiple copies of the driver are unnecessary. For 
this reason, it is best to put the instruction to load the dri- 
ver in the SYSTEMSTART file, 


& 
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rial anne om BRA 


These instructions may be entered interactively, or from a 


SYSTEMSTART file. Input is from Console Input. Output is to the 
CRT (not Console vutput). ; | : 


1) Load the driver program: 


yi 


ea? 


4) 


->L SCCDRIVER 
The driver program iS read from disk. 


Load and execute the initializer progran: 


>G SCCINIT 
The initializer program is read from disk and is executed, 


If more than one serial channel is being used, the initiali- 
zer must be executed once for each channel. 


Input the serial channel name. ) 
The initializer sends the following message to the CRT, 


ENTER DEVICE NAME: 


Respond by keying in the serial channel name, followed by 
presSing the RETURN key. This is the name of the serial 
channel that will be used in the BASIC SET and ASSIGN state- 
ments. The name must have the format SCx---x, where x---x is 
an alphanumeric string of up to 9 characters. (Example; SCTWO) 


Input the I/O address: 


The initializer sends the following message to the CRT, 


ENTER PORT ADDRESS: 


Respond by keying in the I/O address according to the switch- 
es on the serial interface board, followed by pressing the 
RETURN key. For the lower channel on the board (channel Oy 
this is the address set on the interface board Switches. For 
the upper channel, this is the switch address + 2s The 
address is given in hex (for example, if the lower channel is 
68, the upper channel is 6A). If the recommended address is 
Set on the SCC board, the reply will be "60" or "62". 


All syntactically valid port addresses will be accepted by 


‘the initializer. However, if no. SCC board is installed with 


the address given, an error will occur when the driver 
attempts to use it, | 
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5) A status message is returned: 


After entry of the port address (or the device name, if it 
was invalid), a status message is returned to the CRT. These > 
messages are listed in Appendix I of this manual. it foe 
initialization procedure was unsuccessful, the message 
indicates the cause of the failure; in some cases, the 
initializer will repeat the ‘ENTER...' message, to allow 
retries, If the initialization procedure succeeded, the 
message 


QO. VERSION m.nn LOADED 


1s sent to the CRT. m.nn is the version number of the driver 
loaded, 


Initialization failures which cause messages 8, 9, 10, or 11 
also output the message SCC DRIVER DELETED, if no other SCC 
ports had been previously initialized. In this case, the 
SCCDRIVER program is deleted from memory. 


After either successful or unsuccessful initialization, SCCINIT 
is deleted from memory. The memory occupied is returned to the 
system buffer. 3 , 


After successful initialization, the serial channel is ready to 
be used, Before using it for communication, however, it will 


usually be necessary to modify the default parameters establish- 
ed by the initializer; this is done via the SET statement. 


Ltializi h rial Channel from BA 


The BASIC statements for initialization of the serial channel 


may be given interactively from the keyboard (Console Input) or 


they may be executed from the program. 


1) Load the driver program using the LOADA command. 


LOADA "“"SCCDRIVER" 


SCCDRIVER is the name of the serial driver program. The 
Operand may alternatively be a string expression which. 
evaluates to SCCDRIVER. 


The driver program is read from disk. 

2) Load and execute the initializer program. The CALLA command 
1s used, with three optional parameters. When the statement 
is executed, the initializer program is read from disk, if it 
is not already in memory, and is executed. 


The syntax of the CALLA statement is: 


CALLA "SCCINIT" {,<name$>,<addrS$>{,<msg$>}} 


. 
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SCCINIT is the name of the serial initializer program. This 
operand may alternatively be a string expression which 
evaluates to SCCINIT. 


Either both the first two operands must be included in the 
call, or both must be omitted. If omitted, the SCCINIT 
program will request them from the Operator, as is done when 
SCCINIT is invoked from ZEBRA (see above). 


The third operand is ignored if the first two are omitted. 
Otherwise, it iS optional; if included, an initializer status 
message will be returned in it. 


nameS$ = a string variable whose value is the serial 
channel (device) name. The name must have the format 
SCx---x, where x---x iS an alphanumeric string of up to 
9 characters. This is the name that will be used in 
BASIC SET and ASSIGN statements. | 


addr$ = a string variable whose value is: the I/O ad- 
dress. For the lower channel on the board (channel 0), 
this is the address set on the interface board switch- 
es. For the upper channel, this is the switch address + 
2. The address is given in hex (for example, if the 
lower channel is 68, the upper channel is 6A.) If the 
recommended address is set on the SCC board, the reply 
Will be “60° or "62° 4 


All syntactically valid port addresses will be accepted 
by the initializer. However, if no SCC board is 
installed with the address given, an error will occur 
when the driver attempts to uSe it. 


msg$ = an optional String variable. It controls the 
destination of the status message returned by the init- 
Lalizer (eee Appendix Ty.” . 


If msg$ is included, the status message returned from 
the initializer program is put in this variable. The 
String variable must have been defined before the CALLA 
is executed. The message is left justified in msgs. If 
msg$ is longer than the message, the balace of the 
String is filled with spaces. If msg$ is shorter than 
the message, the message is truncated to fit the string. 
The first 2 bytes of msg$S may be analysed in a BASIC 
program to determine the success or failure of the 
initialization. , 


I£ msg$ is not included, the status message is sent to 
the CRT. 


If the initialization procedure was unsuccessful, the 
status message indicates the cause of the failure. 
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If the initialization procedure succeeded, the status 
message iS: 


0. VERSION m.nn LOADED 


m.nn is the version number of the driver loaded. 
Initialization failures which cause messages o,>87 10, O6oit 
also output the message SCC DRIVER DELETED to the CRT, if no 
other SCC ports had been previously initialized. In this case, 
the SCCDRIVER program is deleted from memory. 


After either successful or unsuccessful initialization, SCCINIT 
is deleted from memory. The memory occupied is returned to the 
system buffer. 


After successful initialization, the serial channel is ready to 
pe used. Before using it for communication, however, it will 
usually be necessary to modify the default parameters establish- 
ed by the initializer; this is done via the SET statement. 


It 1S important to note that SCC ports are initialized as unas- 
Signable and unreleasable. Thus, SCC I/O may not be redirected 
to other physical devices and the only way in which SCC ports 
may be deleted from memory is by reloading the operating system. 


The Driver 
The primary functions available in the SCCDRIVER are as follows: 
SETUP Initialize or modify port parameters, and RESET 
the port. | | 
RESET Reset the port to a quiescent state, conditioning 


the SCC according to current values of the port 
parameters, and clearing data buffers; this ef- 
fectively leaves the port ready for a new con- 
nect. 


INITPORT Currently implemented as equivalent to RESET. 


FORCEOUT If in output mode, drain the output buffer by 
waiting for all characters in it to be transmitted. 


BSOUT .- Transfer a single character from the Calling pro- 
gram to the output buffer, ready for transmission. 


BSIN Transfer a Single character that has been received, 
from the input buffer to the Calling program. 


BLKOUT Transfer a block of data from the Calling program 
to the output buffer, ready for transmission, 


BLKIN Transfer a block of data that — has been received, 
from the input buffer to the Calling program. 


& 
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CLOSE A combination of FORCEOUT then RESET, | 


BASIC Statements 


The relationships between BASIC statements and these primary 
functions is not always unique. For example, the PRINT statement 
may sometimes utilize a BLKOUT function, and sometimes a BSOUT 
function. In general, however, they are: 


BASIC statement  SCCDRIVER function 
SET SETUP 
PRINT BLKOUT or BSOUT 
PRINTUSING | BLKOUT or BSOUT 
INPUT BLKIN or BSIN. 
INPUTLINE BLKIN or BSIN 
FETCH BLKIN 
CLOSE CLOSE 


One other BASIC statement is also directly relevant to use of 
the SCC driver, and that is the ASSIGN statement: 


ASSIGN |<unbound logical file no.>| TO: "SCx=-—x" 
|<system logical device> | 2 


This links the BASIC logical address used in the I/O statements 
above, to the SCC port (see definition of "SCx---x" below). The 
formats of all BASIC statements are as defined in the BASIC 
manual (p/n 9212077), with the exception of SET. The format of 
SET required for an SCC port is: : 


SET “SCx--+x "7 <cpl>,<lpp>,<nulls>,<baud>,<prot>,<icto>, 
<iqs>,<oqs>,<mode> 


where SCx---x = the serial channel (device) name. This is_ the 
Serial channel name defined during initializa- 
tion, © It may alternatively be a string express- 
ion that evaluates to SCx---x. 


and all other parameters are numeric expressions: 


<cpl> = the number. of characters per line. The driver 
does not currently utilize the value passed in 
this parameter. 3 

<lpp> = lines per page. The value passed in this para- 


meter is also currently not used by the driver. 


<nulls> = the number of ASCII null characters to be auto- 
matically inserted during transmission following 
a linefeed character. This may be needed for 
some printer terminals that do not’ suppress 
printing during 'flyback'" (i.e., when the print 
head is returning to its left margin). The value 
specified must not exceed 255. : 


a 
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<baud> 


the baud rate (speed in bits per second) at which 
characters may be transmitted or received via the 
SCC. See Table 4.1 for permissible values. 


the physical protocol to be used for transmission 
and/or reception. The permitted values are: | 

0 full-duplex (no echo) 

1 Simplex input 

2 Simplex output 

3 half-duplex 

4 full-duplex with echo 
These values are discussed further, below. 


<prot> 


<icto> 


the inter-character time out period (in seconds) 
allowed on input. The time values allowed are 0 
through 254 seconds, while a value of 255 means 
that no time-out period is in effect. For exam- 
ple, if icto = 5, a terminal operator must not 
wait more than five seconds between keying char- 
acters during input; otherwise an error  condi- 
tion will be generated (see below). 


<iqs> = the input queue (data buffer) size in characters. 
The maximum value is 255. The value passed in 
this parameter is ignored if the protocol speci- 
fied is simplex output. 


<oqs> the output queue (data buffer) size in charac- 
ters. The maximum value is also 255. The value 
passed is ignored if the protocol specified is 
Simplex input or half-duplex. (note: for half- 
duplex, the value specified in igs is used, 
Since only one buffer is allocated and used for 
both input or output. For full-duplex protocol, 
two separate buffers are allocated). 


the valid values for this parameter are shown in 
Table 4.2. It defines whether odd, even, or no 
character parity checking is to be performed by 
the SCC, as well as the character length (5 to 8 
bits). It also defines the number of 'stop' bits 
(1, 1.5, or 2) per character. The mode value 
required will depend on the characteristics of 
the terminal to be supported via the SCC port. 


<mode> 


-18- 


SHCHSHSHSHSHPHESKCHHSHSKSHHAIIHSIIDIAIHDVIDIIDIDDIDIDIDIIVdddddDIAIAINOG 


i ee ee eee eee eee ee 


SSSG SSP SSKHSHSHKAIIDIIIDIIIAVIIIdIdIdIIIIddIIIHIEELELELE 


A value of -1 specified for any numeric parameter implies that 


no change is required to the current value of the parameter. The 
default values of the SET parameters (in decimal) established 
acter initialigation of a port are: 


<cpl> = 131 

<lpp> = 66 

<nulls> = 0 

<baud> = 300 

<prot> = 4 (full-duplex, with Echo) 

<icto> = 255 (time-outs suppressed) 

<iqs> = 128 (full-duplex, half-duplex, simplex input 
3 only) 

<oqs> = 128 (full-duplex, simplex output only) 

<mode> = 


78 (asynchronous, parity disabled, 8 data bits, 
1 stop bit = hex 4E). | 


Programming Techniques 


As indicated in the discussion of the SET parameters, the values 
to be SET by a progam will depend on the terminal to be support- 
ed and on the communications facilities (i.e., the type of mo- 


dems, if any). Consult the appropriate equipment manuals for 


further information. : 


The physical protocol should be set as follows: 


Full-duplex = - for terminals that have both input and out- 
put devices, and both the terminal and com- 
munications facilities support full-duplex. 


Half-duplex - for terminals that have both input and out- 
| put devices, but either the terminal or the 
communications facilities do not support 

full-duplex. 


Simplex input - for terminals that have an input device 
| | only. 
Simplex output - for terminals that have an output device 
only. | 


When operating in full-duplex mode, many terminals do not auto- 
matically couple their input device to their output device in- 
ternally. For example, most simple keyboard/CRT terminals do 
not; this means that characters keyed in are not displayed on 
the CRT, but are simply transmitted to the computer. The SCC 
driver has a special 'Echo' facility that allows received char- 
acters to be immediately sent back to the terminal for display, 
Hk tequited.--This facility.is invoked; by =-setting* <prot>: =s<4 
(full-duplex, with Echo). The Echo facility is not available in 
half-duplex mode, since most such terminals automatically dis- 
play characters as they are keyed in, when operating in half- 


duplex. ‘ 
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A full-duplex application in which Echo might be used select- 
ively is that of password protection. While the terminal Oper- 


_ ator is entering his password -to a restricted service, Echo 


would be suppressed (i.e. <prot> = 0). Thereafter, it would be 
activated by a further SET with <prot> = 4. | | 


The error codes that may be returned by the driver following a 
BASIC statement to the SCC, are shown in Table 4.3. These codes 
are available in the BASIC variable EN, and should normally be 
interrogated by the program if an ONERROR statement is executed 
(l.e., at the statement number addressed in the ONERROR state- 
ment). Certain of these error conditions require special treat- 
ment, due to the nature of the communications environment. The 
first of these is code 23 -- Not Available. Before explaining 
its meaning and use, it is important to understand that the 
driver can support communications to a terminal via: 


* a direct link (no modems) : 

* a dedicated link (with modems, on a private line) 

* a dial-up link (with modems, via a switched telephone 
network). | 


The 'Not Available' code applies only in the third case (dial- 
up), and indicates that the link has not yet been established. 
To establish the link and allow communications requires Opera- 


- tor action at either one or both ends of the link, depending on 


whether the answering modem is of the auto-answer or manual- 
answer type. Refer to the appropriate modem equipment manual for 
further information regarding the procedure for originating and 
answering calls in the dial-up environment. In any case,’ the 
program's response to code 23 should be to continually retry the 
I/O statement that failed. For example: 


160 PRINT #1, "GOOD MORNING " 
165 ONERROR 300 : 
| : 
| (normal processing) 
1 | | 
300 IF EN = 23 GOTO 160 
| 


| (other error processing) 


Once the link has been established, this example program would 
automatically proceed with normal processing. | 


The second error code of particular interest is 51 -- Carrier 
Lost. This implies that the communication link has in some way 
been broken. It may most commonly be expected to occur on dial- 
up ports. The program should probably request Operator interven- 
tion in this case, since retrying the failed statement would be 
Futile. 


If an inter-character timeout has been specified for input (see 


the SET description above), and the timeout condition occurs, 


it will be reflected to the BASIC program as error code l -- 


Buffer Empty. The timeout facility is primarily intended for 
use in the long-distance dial-up environment. Suppose, for exam- 
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ple, a terminal Operator in New York forgets to disconnect a 
link to a 625 in Los Angeles when he leaves work one evening; 
his boss may well be very unhappy about the resulting phone bill 
if the link were to remain connected all night! To prevent this, 
the BASIC program could, for example, alert the 625 Operator 


following a timeout Peer Es On, requesting disconnection of the 


link. 


The next error condition of interest is Buffer Full (error code 
2), On input. This may occur if the BASIC program fails to serv- 
ice an incoming data stream sufficiently rapidly, and the comp- 
uter cannot Signal the remote terminal to stop transmitting on a 
buffer near-full condition (see Chapter 3 -- Special Use of the 
DTR Signal). Implicit with the Buffer Full condition is that 
data has been lost. Thus, the BASIC program should send a mess- 


age to the remote terminal, requesting re-transmission of the 


last line of data. However, before doing this, the program 
Should first 'drain' the input; for example, it may issue a new 
SET statement with a short timeout specified (e.g. <icto>j|= 2), 
and continue to FETCH the remainder of the incoming data as fast 
as possible, until the end of the line is reached or until Buff- 
er Empty occurs. Following transmission of the error message, 
the normal SET conditions should be restored. If the Buffer Full 
condition occurs frequently, a larger input buffer should be 
allocated (<iqs> in the SET Rea E Sere 


The Overrun, Framing Error, and Parity Error conditions (codes 
48, 49, and 50 respectively) may be treated in a Similar manner 
to input Buffer Full, since in all cases the last line of input 
data has been corrupted. These errors do not apply for output. 
(Note: if any of these errors occur continuously as soon as'- the 
BASIC program is started, the <baud> or <mode> parameters of the 
SET statement are probably in error.) 


The SCC driver is a fully re-entrant program, which implies that 
it can support multiple terminals concurrently. It is also an 
interrupt-driven program, which means that it can perform data 
transmission from an output queue, or data reception into an 
input queue, independently of I/O requests from the User program. 
For example, data may be received from a terminal and placed in 
an input queue before the User (BASIC) program issues an 
INPUTLINE statement. The INPUTLINE simply accesses data from the 
input queue —- not directly from the terminal. 


The BASIC language is not, however, iaeetis Suited to take ad- 
vantage of these facts. In a BASIC program, each SCC port must 


be addressed in turn, not concurrently; that is, input or output 


procesSing can only be going on for one terminal at a time. This 
Can present a problem in the multiple terminal environment. 

Suppose, for example, an INPUTLINE statement is executed to a 
keyboard/CRT terminal, via an SCC port. The terminal Operator 
must key in a complete line (terminated by carriage return) 
before the next statement in the program will be executed. If 
the Operator is slow in keying in data, he holds up the’ system; 
that is, no other terminals can be serviced while he is respond- 
ing to the INPUTLINE statement. To circumvent this problem, all 
input in a multi-terminal system may be executed uSing FETCH 
Statements, in conjunction with a short inter-character timeout 
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Specification (SET) for the SCC ports (e.g., <icto> = 1): 


200 FETCH #1,C15§ “GET ONE CHAR FROM TERMINAL 1. 
205 ONERROR 400 
| 
| = | 
400 IF EN=1 GOTO 600 | "TIMEOUT - SERVICE NEXT TERMINAL 
| 


| | | 
600 FETCH #2, C2$ -- 'GET ONE CHAR FROM TERMINAL 2. 
| 


In this way, the program can accumulate input from the _ several 
terminals quasi-concurrently, without significantly delaying 
operation. The timeout technique cannot be used with the INPUT- 
LINE statement, since each time the latter is executed its input 
string is effectively cleared; thus characters previously keyed 
in would be lost. See the sample programs in Chapter 5 for ex- 
amples of the FETCH/timeout technique. 
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Asynchronous 
50 800 
75 1200 
120 1760 
134.5 1800 
150 2152 
200 2400 
300 3200 
600 4800 

9600 

E 


~234 


Synchronous 


(Not supported — 
in Version 5.00). 
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In Table 4.2 part 2, the terms used have the following 
Significance: 


The number of bits used to define the end of a character, in. 
asynchronous communication. This is a terminal dependent 
characteristic. | 


Disabled: | og 
Input; If <character length> data bits are not .received, 
the FRAMING ERROR condition is generated. 
Output: No parity bit is transmitted. 


Odd Parity: | 

Input: The system inputs <character length> data bits, 
plus the parity bit. If the character parity is 
not odd, then the PARITY ERROR condition is 
generated. ! | 

Output: The system generates the parity bit to give odd 

Character parity, then transmits <character : 

length> data bits plus the parity bit. 


Even Parity: | 

Input: The system inputs <character length> data bits, 
plus the parity bit. If the character parity is 
not even, then the PARITY ERROR condition is 
generated. 

Output: The system generates the parity bit to give even 
Character parity, then transmits <character 
length> data bits plus the parity bit. 


On input, <character length> bits are input; they are put in 
the most significant bits of the data byte; remaining bits 
are 0. On output, the most Significant <character length> 
bits of the data byte are transmitted. Remaining bits are 
lost. | 3 


d s - Termin O rt 


-24- 


SOS SSeS SSST SSS SSS SSTSTS SST SSSEPI SIGE ISIIIIGIAIAT 


eed eeeSeECSCEC EEC EBZCEECEECPAERCESEDEPI@DAEEA@PIEEBEEOEOODASOAIUEGOaDdaoawQgaosv~@gwvwvodgdddg Eg 


42 1 Disable 5 
46 a Disable 6 
4A ah Disable - 
4E ae Disable 8 
a 4 1 Odd 5 
56 1 Odd 6 
5A 1 Odd 7 
5E 1 Odd 8 
ie 1 Even 5 
76 1 Even 6 
TA 1 Even 7 
TE 1 Even 8 
82 LS Disable 5 
86 Le Disable 6 
8A Bee Oe: Disable 7 
SE 135 Disable 8 
92 155 Odd 5 
96 13 Odd ae 
9A ESS Odd eS 
9E LS Odd 8 
B2 eee Even 5 
B6 eS Even 6 
BA 145 Even 7 
BE ee Even 8 
C2 2 Disable 5 
C6 2 Disable 6 
CA 2 Disable 7 
CE 2 Disable 8 
D2 2 Odd 5 
D6 2 Odd 6 
DA 2 Odd 7 
DE 2 Odd 8 
F2 o Even 5 
F6 2 Even 6 
FA 2 Even 7 
FE 2 Even 8 
AB f Mode Values - A hronous (Part ang 
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(Dec) 


1 


23 


48 


49 


50 


ont 


70 


71 


be 


113 


(Hex) 


Ei 


17 


30 
31 
ae 
33 


46 


47 


70 


71 


Meaning 


BUFFER EMPTY : 

An attempt was made to input from an empty 
queue, and the specified inter-character timeout 
has occurred without the arrival of further 
characters. | 


BUFFER FULL 
An attempt was made to input or output with the 
queue already full. Received data has been lost. 


\ 


NOT AVAILABLE 


Communications link not yet established (e.g. 


waiting for dial-up connection). 


OVERRUN ERROR 
Characters lost during reception. 


- FRAMING ERROR 


While receiving, did not find stop bits. 


PARITY ERROR | 
While receiving, found parity bit in error, 


CARRIER LOST 
Communication link has been broken, 


READ ONLY 
An attempt was made to output on a simplex 
input port. 


WRITE ONLY | 
An attempt was made to input on a simplex 
output port. 


WRONG NUMBER OF PARAMETERS. 
Invalid parameter count in the SET statement. 


ILLEGAL PARAMETER 
Invalid parameter in the SET statement. 


rror des ret n d 
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The following examples illustrate the use of a variety of the 
SCC driver features, and support for different terminal types. 
In those cases in which the program provides the port initial- 


ization parameters, the standard SCC controller address (hex 60) 
is used, eae 


These examples assume that the SCCDRIVER program has_ been 
loaded, but that the serial channels have not been initialized. 
The programs include initialize statements, and the SET state- 
ments to configure the serial channels to the proper parameters. 


Cable diagrams are given for each example, to show the proper 
Signal connections between the computer's serial connector and 
the connector of the external device. For reference, the cable 


diagrams for two standard cables Supplied by Compucorp are given 
in Appendix II. | 
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ExXampt € - Output to a Texas Instrument [-8]10 Printer 


This program outputs a test message that contains all characters 
of the alphabet: 


THE QUICK BROWN FOX JUMPS OVER A LAZY DOG 


After loading the program, and issuing RUN, the program init- 
ljalizes the SCC port and asks the Operator to enter the number of 
repetitions of the test message to be transmitted in one pass. 
Upon entry of a positive value in response to this’ request, 
transmission to the printer proceeds. A zero or negative response 
terminates the program. 


The TI-810 is directly eeteeeo to the SCC port using the follow- 
ing cable connections: 


“Computer TI-810 
(signal) (pin) (pin) (signal) 
TxD aaa ae ad Ps el 3 RxD 

Cre oJ notententententententestentetontetenten 11 
Yi oatenteatetententententatentestenenten 7 
RLSD 8 i l- 6 DSR 
| ---------- | 


L6 =| > l- 8 RLSD 


Alternatively, Compucorp cable p/n 0169250 may be used (see 
Appendix II for connections in this cable). 


Connections for other signals (e.g. RTS, DTR, etc.) may be pres- 

ent in the cable, but they will serve no function. Pin 16 at the 

SCC port connector is used to Supply a continuously high signal | 
level, and pin 11 at the printer connector is used to control 

transmission rate from the computer (see Chapter 3). 


The TI-810 is an asynchronous device whose operating parameters 


(baud rate, parity, etc.) may be altered via internal switches. 


These switches must be set to correspond to the BAUD and MODE 


parameters of the program (see below). 
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10 
20 
30 
40 
50 
60 
70 
80 
100 


peice 


120 
130 
140 
150 
160 
165 
170 
180 
190 
200 
300 
500 
510 


N1S="SC1" 3 ‘Define Device Name and 
N2$="60" "Port Address. 
CALLA "SCCINIT",NLS, wos ‘Initialize the Port. 
CPL=-1 ‘'Define parameters for SET. 
LPP=-] ees 
BAUD=96 00 , ; 

PRCL=2 | | " = simplex output. 
ICTO=255 ' = suppress timeouts. 
IQS=0 ' = no input queue. 

OQS=-1 

NULLS=0 

MODE=&4E ' = async, 8 data bits, 1 stop bit, no parity. 


SET "SC1" TO CPL,LPP,NULLS,BAUD, PRCL, ICTO, 1QS,0QS,MODE 
ASSIGN #1 TO "SCL" 

INPUT “NUMBER OF REPETITIONS";A 

IF A=<0 GOTO 500 "Stop if 0 or neg value entered. 
PRINT #1,"THE QUICK BROWN FOX JUMPS OVER A LAZY DOG" 
ONERROR 300 


A=A-1 "Decrement count. 
IF A=0Q0 THEN 160 ELSE 170 'When this test done, do another. 
PRINT "ERROR NUMBER = ";sEN | 3 
STOP 
END 
Program for Example 1 
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Example cm O to a SOROC ITO 120 (A; Keyboard/CRT) terminal 


This program supports full-duplex communication via telephone 
lines of data entered by the Operator at the terminal for dis- 
play at the computer, and data entered by the Operator at the 
computer for display at the terminal. After loading the program 
and issuing RUN, the program allows the computer Operator to 
enter the port initialization parameters. The DEVICE NAME is 
SCl. The PORT ADDRESS is 60 if the lower channel is used, 62 if 
the upper channel is used. This done, it repeatedly tries to 


send a ‘Good Day' message to the terminal Operator, until the 


dial-up communication path has been established. Both Operators 
are then requested to ‘Enter Data' followed by a carriage re- 
turn, The data each enters is transmitted for display at the 
other device. Note that delay in entering a complete data line 
ac Gitner end, can hold up the system. 


Communication between the IQ 120 terminal and the computer is 
established via the switched telephone network, using Novation 
DC-3103A dial-up acoustic modems, The cable connections are: 


Computer Modem Modem LO.) 20. 
(sig) (pin) (pin) (pin) (pin) (sig) 
ae 1 jag 7? ea 1 
nr 2 a ays ae 2 TxD 
RxD Fe 3 =omssessese= 30 ew ee ee 3 RxD 
a 5 ei oes S 5 crs 
‘ee 7 ere 7 


RLSD 8 ---------~- 8 


Connections for other signals (e.g. DSR, DTR, RTS) may be pre- 


Sent in the cable, but they will serve no function. 


The IQ 120 is an asynchronous keyboard/CRT terminal that may be 
Switched to operate in half or full-duplex, and at different 
line speeds (switches on rear panel). Internal Switches also 
allow its character length, parity, and number of stop bits to 
be altered. These switches must be set to correspond to the 
BAUD, PRCL, and MODE parameters of the program (see below). 


The modems must be switched on before executing the program. The 


communications link may be established before or after execution 


1S Started, 
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30 CALLA "SCCINIT" "Operator will initialize port. 


40 CPL=-1 ‘'Define parameters for SET. 

50 LPP=-1 

60 BAUD=300 ' = max speed of modems used. 

70 PRCL=4 " = full-duplex with echo. 

80 ICTO=255 | " = suppress timeouts. 

100 IQS=- 

110 OQS=-1 

120 NULLS=-1 

130 MODE=&4E " = async, 8 data bits, 1 stop bit, no parity. 
140 SET "SC1" TO CPL, LPP, NULLS, BAUD, PRCL, ICTO, I19S,0QS,MODE 

150 ASSIGN ta O° SC1™ 

160 PRINT #1,"GOOD DAY. " "Opening msg retried till 

162 ONERROR 400 ‘dial-up connection complete. 

170 BS="ENTER DATA (CR): " 

175 RS$="RECEIVED DATA = " 

180 PRINT #1,BS "Request data from terminal Opr. 
182 ONERROR 500 

185 PRINT BS ‘Request data from computer Opr. 
190 DS="" | ‘Initialize data accumulator. 

200 FETCH #1,CS$ "Get a char from terminal. 

210 ONERROR 600 : 

220 IF CS= CHRS (13) THEN PRINT #1: GOTO 250 "If carriage ret, 
230 D$=D$+C$ ‘Accumulate input data string. 
240 GOTO 200 | 

250 PRINT RS;DS | ‘Display rec'd data at computer. 
260 PRINT #1,BS "Ask for more data from terminal. 
270 ONERROR 500 | 

280 INPUTLINE DS "Get data line from computer Opr. 
290 PRINT #1,RS;DS$ "and transmit it to terminal. 

300 GOTO 185 | "Ask for more data from comp. Opr. 
400 IF EN=23 GOTO 160 "Not Available - retry.... 

500 PRINT "ERROR NUMBER = ";EN | | 

510 STOP 

600 IF EN=51 THEN 500 "Carrier Lost. 


610 PRINT #1 "Else, overrun, parity, or framing error. 
620 PRINT #1,"ERROR; RE-ENTER DATA (CR): " . 

630 ONERROR 500 | 

640 GOTO 190 ‘Restart input from terminal... 
650 END 


Ogram FOr m 


-3]- 


EE ES LE I EES r er er Vr er ee eh —hUST—SEU Sessa eaee@e@aedgceaq@wat oa oS aS ae a a a ee Ce ee 


SSSSSSSSSTSESSESADAIAIAAADIDIADIADIAADAIDIIDIADADIIIIIIIOSS< 


Example — O to a NE 0 (Keyboard/Printer ermina 


This program is functionally the same as Example 2. However, a 
direct connection is used between the terminal and computer: 7 


Computer NEC 5520 
(Signal) (pin) (pin) (signal) 
do -------------- 
TxD oe ee el 3 RxD 
RxD 3 -------------- 2 TxD 
Po wren 7 
RLSD 8 -| l- 6 DSR 
|---------- | | 
16 -| | i= 2 RLSD 
DTR 20 -------------- 5 CTS 


Pin 16 at the SCC port connector is used to Supply a continuous- 
ly high signal level, and Pin 20 controls the transmission rate 


from the terminal to prevent an input buffer full condition at 


the computer (see Chapter 3). 


Alternately, Compucorp cable p/n 0169821 may be used (see Ap- 
pendix II for connections in this cable). 


The NEC 5520 is an asynchronous terminal whose Operating para- 


meters may be altered via front panel and internal switches. 
These switches must be set to correspond to the BAUD, PRCL, and 
MODE parameters of the program (see below). The terminal req- 
uires that data transmitted to it be terminated by an End-of- 
Text (ETX) character, It will then reply with a positive or 
negative acknowledgement (ACK or NAK) character to Signal 
success Or failure of the transmission. The ETX/ACK protocol is 
also an internal switch option on the terminal. 
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CEOESEDBEEBTEEADHEEDADADAGBABDOABDOODADAPAOSBAADAADDIDAIAHAGAAHG4GO46HOH44SH: 


CALLA "SCCINIT" 


‘Operator will initialize port. 


CPL=-1 ' "Define parameters for SET, 
LPP=-] | 
BAUD=1 200 ' = max speed of terminal. 
PRCL=4 ' = full-duplex with echo. 
ICTO=255 ' = suppress timeouts. 
IQS=20 " = small buffers save memory. 
0QS=50 3 
NULLS=6 ' = suppress flyback printing, 
MODE=&5A  ' = async, 7 data bits, 1 stop bit, odd parity. 


SET "SC1" TO CPL,LPP, NULLS, 


ASSIGN #1 TO "SCl1" 


BAUD, PRCL, ICTO, IQS,0QS,MODE 


CLES= CHRS (13)+ CHRS (10)+ CHRS (3) ' = CR, LF, EX. 


PRINT #1,"GOOD DAY." 
ONERROR 500 

BS="ENTER DATA (CR): " 
RS="RECEIVED DATA = ". 
PRINT #1,BS+CLES; 
ONERROR 500 

GOSUB 800 

PRINT BS 

DS=" 08 

FETCH #1,CS 

ONERROR 600 


"Request data from terminal Opr. 


"Check acknowledgement. 

‘Request data from computer Opr. 
‘Initialize data accumulator, 
‘Get a character from terminal. 


IF ( ASCII (C$) AND &7F)=13 THEN PRINT #1,CLES$: ELSE 230 


ONERROR 500 


PRINT RS3;DS 

PRINT #1,BS+CLES; 
ONERROR 500 

GOSUB 800 
INPUTLINE DS 
PRINT #1,RS;D$ 


GOTO 187 | 
PRINT "ERROR NUMBER = ":EN 
STOP | 


IF EN=51 THEN 500 


~GOSUB 800 -'Check acknowledgement. 
GOTO 250 | 
DS=D$+ CHRS ( ASCII (CS) AND &7F) ‘Add to input string. 
GOTO 200 7 


‘Display rec'd data at computer. 
‘ASK for more data from terminal. 


"Check acknowledgement. 
‘Get data from computer Opr. 
‘Send it to terminal. 7 


‘Ask for more data from comp Opr. 


"Carrier lost. 


PRINT #1 ‘Else, overrun, parity or framing error. 
PRINT #1,"ERROR; RE-ENTER DATA (CR): "+CLES 3: 


ONERROR 500 
GOSUB 800 
GOTO 190 
FETCH #1,AS 
ONERROR 500 


"Check acknowledgement. 
"Restart input from terminal... 
"Get acknowledge char. 


IF ( ASCII (AS) AND &7F)=6 THEN RETURN ae SO0G.. 5 
EN=999 "Bad ack. 
GOTO 500 . 
END 
Program for a e 


ee 2 ae 


SET TSI TISSE TEST SES ESS SISSIES SSSSIDSSIIDGISGIISGIIIIIITEE 


GOGO OHDHAGODADHAHDOHODDDADADDDADOADDDAIDAIADDAAADAADADIAADAIADADAHKIDGOHHKDIDOEE 


uxample 4 - Concurrent output to a TI-810 and an NEC ' 


This program is functionally similar to that of Example 1, ex- 
cept that two printers are directly connected. They are driven 
at different speeds, and with different Operating parameters 
(parity, character length) to one another. Be sure to. set the 
internal switches on the printers to match the Bl, B2, Ml, and 
M2 parameters of the Program. Standard cables may be used -- 
0169250 for the 810 and 0169821 for the 5520. 3 


2 Nl1S$="SCl" | "Define Device Names’ and 
4 N2S="60" | "Port Addresses, 

6 P1S="SC2" 7 

8 P2S="62 ve 


10 CALLA "SCCINIT",N1$,N2$ "Initialize the ports. 
20 CALLA "SCCINIT",P1$,P2S$ 


30 CPL=-1 "Define parameters for SET, 

40 LPP=-] 7 

50 B1l=9600 ' = ‘fast' printer. 

60 PRCL=2 ' = simplex output. 

70 ICTO0=255 : ' = suppress timeouts. 

80 IQS=0 

90 OQS=-1 

100 NULLS=0 

110 Ml=&4E cMG asyne, 8 data bitsy bystop bit {no parity. 


i120 SET "SCl1" TO CPL,LPP, NULLS,B1,PRCL, ICTO,1QS,00S,Ml 

130 ASSIGN #1 TO "SC1" 

140 B2=1200 " = NEC printer. 

160 M2=&7E . * async, 7 data bite; i stop bit, even parity 
170 SET "SC2"::TO CPL,LPP, NULLS,B2,PRCL, ICTO, 1QS,00S,M2 | 
180 ASSIGN #2 TO "Sc2" 

185 MS="THE QUICK BROWN FOX JUMPS OVER A LAZY DOG" 

190 INPUT "NUMBER OF REPETITIONS" :A 


200 IF A=<0 GOTO 500 ‘Stop if 0 or neg value entered. 
210 B=A | ‘Set rep count for slow printer. 
230 C=B1/B2 ‘Ratio for relative print rates, 
240 PRINT #2,MS = ‘Output to slow printer. 

250 ONERROR 450 : roe 

260 B=B-] 
2/0 IF A=0 THEN 340 "If fast printer finished.... 
280 PRINT #1,MS | ‘Else, output to fast printer. 
290 ONERROR 400 

300 A=A-1 

310 IF A=0 THEN 340 

320 C=C-1l 

330 IF C=<0 THEN 230 ELSE 280 'Which next? - fast or Slow.... 
340 IF B=0 THEN 190 ELSE 240 'I£ slow done, repeat test... 
400 PRINT "SCl ERROR NUMBER = "EN 

410 STOP | 

450 PRINT "SC2 ERROR NUMBER = "sEN 


5900 STOP 


Program for Example 
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APPENDIX I 


@ 


INITIALIZER STATUS MESSAGES 


of the following messages is output by the initializer, 


SCCINIT, each time it is executed. 


10. 
Li, 


VERSION m.nn LOADED (successful initialize. m.nn is 
| the driver version number.) 

WRONG NUMBER OF PARAMETERS (if more than 3 passed) 

INVALID PARAMETER (Port address invalid) 

INVALID PARAMETER (Device name invalid) 

INIT FAILED 7 (System problem. Should never 

; occur) 

DUPLICATE NAME (Device name assigned to 
previously initialized port) 

PORT ALREADY INITIALIZED | (The port address has already 

| a been initialized.) 
SCC DRIVER NOT LOADED (The SCC driver program is not 
| in memory.) 
INSUFFICIENT MEMORY (The system buffer isn't large 


i enough to hold the port). 
CAN'T ALLOCATE INTERRUPT VECTOR. 
(System problem. Should never 
occur) 
SET FUNCTION FAILED (Failed to SET default values) 
DRIVER AND LOADER VERSION MIS-—MATCH 
(The version numbers of the driver and initializer 
programs are different. In order to preclude incor- 
rect operation due to version number differences, the 
initializer will not operate if the version numbers 
are different.) 
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APPENDIX II 


COMPUCORP STANDARD CABLES 


p/n 0169250 (Universal serial cable, for the TI-810) 


This cable 1S symmetrical. Both ends are male. 


Od] se---~-- 1 
TxD 2 ------- - 2. Rgp 
RxD 2: eine & 2 TxD 
7 -------- 7 
CTS 5 wao----- Si 
if sss 5 CTS 
DSR 6 <e===|~~ 6. RLS 
| [== 9 
: “> 16 
RSLD 8 ---|---- 6 DSR 
2 mee | 
16 ==] 


p/n 0169821 (For the NEC 5510 and 5520) 


Male Female 
TxD 2 --------- 3 RxD 
RxD J ee 2 TxD 
CTS 5 --------- 19 
3 1 i etetestentetentontenten i) 
DSR 6 -|-----|- 6 DSR 
RLSD 8 -|-----|- 8 RLSD 
a6 4 
DTR 20 ------- f= 2 eps 
3 
/ (5.6K) 
; os 
| |- 8 RLSD 


SHDDDADDDADDDDHDDADADDADADDDDIPIAHAIDIDIAIADIAAIDAADE 
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APPENDIX III 


COMPONENT PLACEMENT DRAWING 


The component placement drawing shows the locations of the 
jumpers on the serial interface board. 


(See following page). 


alt 


wwe wwewe we woe wewweeeee ewer wml SeuCU eC eC weer ee Ve eel erClereeVrereOereevGewereonveorewewweeaeaeerel ele orlerl rl 


ene 


ee ee 


EA A EL RT a RE RE ES 


CORIO TS E.R 


SE RY SAO STO SC RS m 


as. 23 a @ 
‘ r 000000000000, ° ooocoovoetes 
= =e A : = & 
ee @o6 “1000 - 


~ 


eo ( 8 )a@se0e( 2 J 


ag ° 
O00 o0e 00000 F agg 


eres. 


eon eon °° 
© 60 600 
70/20 
= ale 
ox oon 
® 
oo 
® 
-) 
9 


Che eee 


=] 
. °e 
r? i cel ‘any ae ecco ° 
pee ey oo. eC 
“ ® 
ise aa ° °° y rong C000, é yy 6000, 
~gerereryrccmen ° 
een °, fie 
——_—_ 000005, ° 9900005 000000, ° 900000a 
‘ eeeeih ° 000000 000006 000000 0000000 
(ec 9 ry r) e c- oS o ° °e ° 
: 2 : ° oe ee ° 42 ° | _ 
le ’ ee Ae : 
7-0000000000000n 0000000000000n bear ee 
& ° © 0 : : S 
‘ | 
° °° - SI re z 0000000 
e Co000000C00bOO © 0 §00000000000000 
‘ © . ie ° 8 ° . ‘ ° - : ° .-] 
0 *e ; 00° a °° .. ° 6 
7 ) . ° °° °° v6” 
sg r @ 
E s 40° 09000008 0000000m. TEE 
fF Smee 5d ® | i ‘ . 
pt marcus ° e 00000be s = “eoeoeoes zt 
APO aie , 6 e : = @ 6 - e 
6 2° ok) e Ge ae pean eae 
8 8 
Yt re: 
‘ ° ° ene cm) 
pee ed 00000000, oo asses, 000000000 99000000 
ees Lk kis : Noted Gat 
00000000 00000000 00000000 0000000 00000000 
oe. : © (KE) © ° © (Rie) © 
° e ° ° ° -] ° . 
0000000 00000002, = = =.900000n 
ee 4 
| 00000000 00000000) co o ‘gogggg 
| © sé 6 ° ses : e Z ® 
a | *o, © t ° @ | 
: | . 0° es eeUrrtt reese ee 
ae Ele eseonoe) Eel Bl 0000 Pel teasens 0000000 
Pin 000000 N I ° 
ao 


o629 CE) €5de CHT neade (UG 


ESSA LD Rg SR Piss cH a cae a etapa a EO a ae erent nen em eins 


aE: = NEGROES ac mam eee rene 


GESSSSOSSOSOSSASECSOSSSCECESCECCESDESECCHCPOPGEECHESGPIOIGIIGISGIGEGsGsGIgGde 


OS HRODVOHOHHPHO HHP HHO POLO LO LE HOLCOOOKLOOOOOOOD OD DHS OO ODDOO 


